Skip to content

docs: build out the CAST PRO-1 section - #1207

Merged
WestwardWinds merged 1 commit into
devfrom
docs/castpro1-section
Nov 3, 2026
Merged

WestwardWinds merged 1 commit into
devfrom
docs/castpro1-section

Conversation

@WestwardWinds

Copy link
Copy Markdown
Contributor

What does this implement/fix?

Builds out the CAST PRO-1 section for launch, modeled on the CAST-1 section. Before this PR the section only had an Introduction and an LED strip page.

New pages

  • FAQ
  • Getting Started: labeled ports photo and table, USB-C power (5V 1A, or 5V 3A with an LED strip), speaker hookup clip, Ethernet / hotspot / Improv setup with a hotspot onboarding clip, Audio Output, and Music Assistant
  • Additional Info: Sensor Definitions (matched to the real device page), ESPHome Device Builder, and Analog In (playing the line-in source from Music Assistant Browse as a Sendspin Source, plus the Line In Streaming options)
  • Examples: TTS and Announcements, WizMote Control
  • Troubleshooting: Boot Mode, Reflash, Status Check and Factory Reset (3 second hold shows connection status on the LEDs, 10 second hold factory resets), and Teardown and Reassembly with clips

Updated pages

  • Introduction: hero image, and the features rewritten for the actual hardware
  • LED Strip: screw terminal order, the LED Strip Test step, Effect A and Effect B slots with the pattern list and photosensitivity warning (from the CAST-1 README), and a partition example for splitting the strip into segments (based on the Halloween example YAML)

Style guide and AGENTS.md: adds a naming rule for CAST PRO-1: display text never says CAST-1 PRO, and the literal device name and hotspot keep CAST_PRO-1 (Apollo CAST_PRO-1 Hotspot).

Media: 10 new WebP assets in docs/assets/cast-pro-1-*, all under 1.5 MB. The hotspot onboarding clip was cut from a phone screen recording: other Wi-Fi networks, the keyboard, browser search suggestions, a password manager prompt and the password characters are cut or masked, and I checked every frame. The photos have no location data.

Notes for reviewers

  • Two TODO comments remain, hidden in the rendered pages:
    • The firmware option name in the installer dialog, on the Reflash page.
    • Whether the CAST-1 WizMote blueprint lists CAST PRO-1 devices.
  • The Analog In page has a placeholder comment for a Music Assistant screenshot.
  • No redirects are needed. None of the moved or renamed pages were ever on dev.
  • check_markdown, check_secrets and check_links pass locally on a full build. check_images couldn't run because exiftool isn't installed on my machine; the images were checked for location data with Pillow instead.

Types of changes

  • Typo / wording fix
  • Content update (correcting outdated info, adding missing steps, clarifications)
  • New page or new product section
  • Page move / rename (redirect added in mkdocs.yml)
  • Image / screenshot update
  • Nav / structure change
  • Site config or theme change
  • CI / workflows / dependencies — Does not publish

Checklist:

  • This PR targets the dev branch (not main)
  • Changes previewed locally with mkdocs serve
  • If pages were moved or renamed, redirects were added to mkdocs.yml
  • If new pages were added, nav was updated in mkdocs.yml

🤖 Generated with Claude Code

Add the CAST PRO-1 pages modeled on the CAST-1 section: FAQ, getting
started (labeled ports, USB-C power, Ethernet, hotspot and Improv setup,
Audio Output), sensor definitions, ESPHome Device Builder, Analog In as a
Music Assistant Sendspin Source, TTS and announcements, WizMote control,
boot mode, reflash, boot button status check and factory reset, and
teardown and reassembly.

Expand the LED strip page with the Effect A and B slots, the pattern
list, the photosensitivity warning, the LED Strip Test step, and a
partition example for splitting the strip into segments.

Add the hero image, labeled ports photo, hotspot onboarding clip, audio
hookup clips, and teardown clips. Add a CAST PRO-1 naming rule to the
style guide and AGENTS.md.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@WestwardWinds
WestwardWinds merged commit 4c4a68c into dev Nov 3, 2026
2 checks passed
@WestwardWinds
WestwardWinds deleted the docs/castpro1-section branch November 3, 2026 23:51
@coderabbitai

coderabbitai Bot commented Nov 3, 2026 •

Copy link
Copy Markdown

Review in Change Stack →

Caution

Review failed

The pull request is closed.

  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

Share

Bunton33 added a commit that referenced this pull request Nov 4, 2026
Zach's CAST PRO-1 section (#1207) covers Line In and the boot button,
so the separate Line In and status check pages are gone. What they had
that his pages didn't now lives on the Analog In page: the one-time
Turn on audio input step, the optical-only output while it streams,
the exact Line In Streaming labels, the requirements, and
troubleshooting.

- Name the jack Analog In (Line In), and add the rule to the style guide
- TTS and sensor definitions: Announcement Ducking and Announcement LED
  Brightness from firmware 26.11.3.3
- Getting Started: the Music Assistant 2.10.7 note, and Static playback
  delay (ms) for a room that plays late (also in the FAQ)
- LED strip: firmware 26.11.3.2, Music Mode follows Analog In, US
  spelling, menu arrows

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Bunton33 added a commit that referenced this pull request Nov 4, 2026
…layback delay (#1205)

Builds on the CAST PRO-1 section from #1207 for firmware 26.11.3.2 and 26.11.3.3.

- Analog In (Line In): requirements, optical-only output while it streams, Music Assistant play steps, Setup required troubleshooting, exact Line In Streaming labels and restart
- Name the jack Analog In (Line In), with the rule in the style guide
- TTS and sensor definitions: Announcement Ducking and Announcement LED Brightness
- Getting Started: Music Assistant 2.10.7 note, Setup required step, Static playback delay (ms) tip, hotspot /setup tip
- LED strip: firmware note, Music Mode follows Analog In

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant